package com.nidu.demo.menu.api;

import com.alibaba.cola.dto.MultiResponse;
import com.alibaba.cola.dto.PageResponse;
import com.alibaba.cola.dto.Response;
import com.alibaba.cola.dto.SingleResponse;
import com.nidu.demo.common.enums.StatusEnum;
import com.nidu.demo.menu.dto.*;

import java.util.Set;

/**
 * 菜单服务接口
 *
 * @author auto
 */
public interface SysMenuService {

    /**
     * 创建菜单
     *
     * @param cmd 菜单创建命令
     * @return 创建后的菜单信息
     */
    SingleResponse<MenuCO> add(MenuAddCmd cmd);

    /**
     * 更新菜单
     *
     * @param cmd 菜单更新命令
     * @return 更新后的菜单信息
     */
    SingleResponse<MenuCO> update(MenuUpdateCmd cmd);

    /**
     * 删除菜单
     *
     * @param id 菜单删除命令
     * @return 操作结果
     */
    Response delete(Long id);

    /**
     * 批量删除菜单
     * @param ids
     * @return
     */
    Response delete(Set<Long> ids);

    /**
     * 获取菜单详情
     *
     * @param id 菜单ID
     * @return 菜单详情
     */
    SingleResponse<MenuCO> getById(Long id);

    /**
     * 查询菜单列表
     *
     * @param qry 查询条件
     * @return 菜单列表
     */
    MultiResponse<MenuCO> list(MenuListQry qry);

    /**
     * 查询菜单树
     *
     * @param qry 查询条件
     * @return 菜单列表
     */
    MultiResponse<MenuTreeCO> tree(MenuTreeQry qry);

    /**
     * 分页查询菜单树
     *
     * @param qry 分页查询条件
     * @return 菜单树结果
     */
    PageResponse<MenuTreeCO> page(MenuPageQry qry);

    /**
     * 更新菜单状态
     *
     * @param id 菜单ID
     * @param status 状态值(0:禁用,1:启用)
     * @return 操作结果
     */
    Response updateStatus(Long id, StatusEnum status);
} 